Remove remaining GtkWindow deprecated documentation
authorJavier Jardón <javierjc1982@gmail.com>
Sat, 10 Oct 2009 18:27:57 +0000 (20:27 +0200)
committerJavier Jardón <jjardon@gnome.org>
Sun, 2 May 2010 23:49:50 +0000 (01:49 +0200)
This completes commit 89e3ec8c3d766c333f6e67764ebd7633d61e21cd

docs/reference/gtk/tmpl/gtkwindow.sgml
docs/tutorial/gtk-tut.sgml
examples/colorsel/colorsel.c
examples/text/text.c
modules/other/gail/tests/ferret.c

index 0fa830aa90c1bd8cd9341075faca0cc999ebb893..69a9688fdffd5488a96f8067b5d96066fe65a0e7 100644 (file)
@@ -257,86 +257,6 @@ window (synonymous with gtk_window_add_accel_group().
 @wmclass_class: 
 
 
-<!-- ##### FUNCTION gtk_window_set_policy ##### -->
-<para>
-Changes how a toplevel window deals with its size request and user resize
-attempts. There are really only two reasonable ways to call this function:
-<orderedlist>
-<listitem>
-<para>
-<literal>gtk_window_set_policy (GTK_WINDOW (window), FALSE, TRUE, FALSE)</literal> 
-means that the window is user-resizable.
-</para>
-</listitem>
-<listitem>
-<para>
-<literal>gtk_window_set_policy (GTK_WINDOW (window), FALSE, FALSE, TRUE)</literal> 
-means that the window's size is program-controlled, and should simply match 
-the current size request of the window's children.
-</para>
-</listitem>
-</orderedlist>
-The first policy is the default, that is, by default windows are designed to 
-be resized by users.
-</para>
-
-<para>
-The basic ugly truth of this function is that it should be simply:
-<literal>
- void gtk_window_set_resizable (GtkWindow* window, gboolean setting);
-</literal>
-...which is why GTK+ 2.0 introduces gtk_window_set_resizable(), which you 
-should use instead of gtk_window_set_policy().
-</para>
-
-<para>
-If set to %TRUE, the @allow_grow parameter allows the user to expand the window
-beyond the size request of its child widgets. If @allow_grow is %TRUE, be sure to
-check that your child widgets work properly as the window is resized.
-</para>
-
-<para>
-A toplevel window will always change size to ensure its child widgets receive
-their requested size. This means that if you add child widgets, the toplevel
-window will expand to contain them. However, normally the toplevel will not
-shrink to fit the size request of its children if it's too large; the
-@auto_shrink parameter causes the window to shrink when child widgets have too
-much space. @auto_shrink is normally used with the second of the two window
-policies mentioned above.  That is, set @auto_shrink to %TRUE if you want the
-window to have a fixed, always-optimal size determined by your program.
-</para>
-
-<para>
-Note that @auto_shrink doesn't do anything if @allow_shrink and @allow_grow are
-both set to %FALSE.
-</para>
-
-<para>
-Neither of the two suggested window policies set the @allow_shrink parameter to
-%TRUE.  If @allow_shrink is %TRUE, the user can shrink the window so that its
-children do not receive their full size request; this is basically a bad thing,
-because most widgets will look wrong if this happens. Furthermore GTK+ has a
-tendency to re-expand the window if size is recalculated for any reason. The
-upshot is that @allow_shrink should always be set to %FALSE.
-</para>
-
-<para>
-Sometimes when you think you want to use @allow_shrink, the real problem is that
-some specific child widget is requesting too much space, so the user can't
-shrink the window sufficiently. Perhaps you are calling gtk_widget_set_size_request()
-on a child widget, and forcing its size request to be too large. Instead of
-setting the child's usize, consider using gtk_window_set_default_size() so that
-the child gets a larger allocation than it requests.
-</para>
-
-@window: the window
-@allow_shrink: whether the user can shrink the window below its size request
-@allow_grow: whether the user can grow the window larger than its size request
-@auto_shrink: whether the window automatically snaps back to its size request 
-              if it's larger
-@Deprecated: Use gtk_window_set_resizable() instead.
-
-
 <!-- ##### FUNCTION gtk_window_set_resizable ##### -->
 <para>
 
@@ -373,14 +293,6 @@ the child gets a larger allocation than it requests.
 @accel_group: 
 
 
-<!-- ##### MACRO gtk_window_position ##### -->
-<para>
-Deprecated alias for gtk_window_set_position().
-</para>
-
-@Deprecated: Use gtk_window_set_position() instead.
-
-
 <!-- ##### FUNCTION gtk_window_activate_focus ##### -->
 <para>
 
index 11407be476a60287b654b9b432369ca072cae0f2..c1cd7ddf266857c00f9777cfc88851a44b02b997 100755 (executable)
@@ -6134,7 +6134,7 @@ gint main( gint   argc,
 
   window = gtk_window_new (GTK_WINDOW_TOPLEVEL);
   gtk_window_set_title (GTK_WINDOW (window), "Color selection test");
-  gtk_window_set_policy (GTK_WINDOW (window), TRUE, TRUE, TRUE);
+  gtk_window_set_resizable ((GTK_WINDOW (window), TRUE);
 
   /* Attach to the "delete" and "destroy" events so we can exit */
 
index cd2801c875e91604b121284f2bfeca37a05f5a10..9d3671de697fd051e032af53d6f7ade1ec33bc77 100644 (file)
@@ -90,7 +90,7 @@ gint main( gint   argc,
 
   window = gtk_window_new (GTK_WINDOW_TOPLEVEL);
   gtk_window_set_title (GTK_WINDOW (window), "Color selection test");
-  gtk_window_set_policy (GTK_WINDOW (window), TRUE, TRUE, TRUE);
+  gtk_window_set_resizable (GTK_WINDOW (window), TRUE);
 
   /* Attach to the "delete" and "destroy" events so we can exit */
 
index 2b05c472b52ad90b7442d733a642cfc3b89b87ca..0b6c82574c33f59e35e4c5e769a9a51b4fe8048c 100644 (file)
@@ -47,7 +47,6 @@ int main( int argc,
  
   window = gtk_window_new (GTK_WINDOW_TOPLEVEL);
   gtk_widget_set_size_request (window, 600, 500);
-  gtk_window_set_policy (GTK_WINDOW (window), TRUE, TRUE, FALSE);  
   g_signal_connect (G_OBJECT (window), "destroy",
                     G_CALLBACK (close_application),
                     NULL);
index 4cde9a7b482da953ea804f2eca43cc00562105ca..e6145ae20a2ebf5d0bff0fc4bdd11b6b90710905 100644 (file)
@@ -1666,7 +1666,6 @@ _create_window (void)
     {
         window = gtk_window_new (GTK_WINDOW_TOPLEVEL);
         gtk_widget_set_name (window, "Ferret Window");
-        gtk_window_set_policy (GTK_WINDOW(window), TRUE, TRUE, FALSE);
 
         g_signal_connect (GTK_OBJECT (window), "destroy",
                            G_CALLBACK (gtk_widget_destroyed),